广告 iOS SDK 开发参考说明书

2018-10-09

一、SDK包内容

1) iOS 广告 SDK （AGAdsSDK.framework）是一个静态库，最低支持iOS 8.0 , 使用iOS 11 SDK。
2) 提供 激励视频广告 、 插屏广告 、横幅广告 、 开屏广告功能。

二、SDK 更新说明

接入crash SDK ，监控线上运行情况。由于crash SDK 版本要求关闭 bitcode，因此在工程设置时，增加bitcode=NO的设置操作。

三、SDK的接入说明

广告SDK位置

导入framework第一步

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

四、初始化

1.以上设置完毕后，就可以在代码中引入AGAdsSDK.framework中的头文件了。

#import <AGAdsSDK/AGAdsSDK.h>
@interface ViewController 
@end

2. 初始化

假设您已经申请完成 appId 、以及广告位posId。信息如下：

#define KRewardUnitID @"1525333549677"
#define KAppId @"1000004264"

如果初始化失败，可以再次尝试初始化。


// 初始化
NGAppInfo* info = [[NGAppInfo alloc] init];
info.appId = KAppId;
//
// 测试版本可以打开调试日志，这样更加方便定位问题。
// 发布版本可以关闭测试日志
//
info.debugLog = self;
[[NGASDK sharedInstance] initWithAppId:info
                            withResult:^(NSError * _Nullable error) {
                            
                        //
                        // 同步服务器端配置信息
                        // 如果失败，error中有原因
                        // 原因基本是网络不可用，或者服务器端配置错误
                        //
                        NSLog(@"ads init result %@ - %@"
                              , !error ? @"success":@"failed" , error);
                            }];

查看调试日志方式：


/**
 调试日志输出，只有设置调试模式时候才会有日志输出
 
 @param log 输出调试日志内容
 */
 
- (void) sdkDebugLog:(NSString* _Nonnull) log
{
    NSLog(@" -- ADS LOG -- : %@" , log);
}

五、广告 加载、显示、回调

1.激励视频、插屏广告

a. 激励视频和插屏广告加载广告

    
     NGAdsObject* rewardAds = [[NGAdsObject alloc] init];
    rewardAds.posId = KRewardUnitID; 
    rewardAds.type = ADTypeRewardAds;// 插屏使用 ADTypeInterstitialAds
    rewardAds.delegate = self;
    
    [rewardAds loadAd];

b. 显示广告



    if ([self.rewardAds isReady]) {
        [self.rewardAds showAdWithViewController:self];
    } else {
        NSLog(@"激励视频广告还没有准备好");
    }

c. 回调函数

请实现如下接口：

2.横幅广告

a. 横幅广告加载广告

    
    NGAdsObject* bannerAds = [[NGAdsObject alloc] init];
    bannerAds.posId = KBannerID;
    bannerAds.type = ADTypeBannerAds;
    bannerAds.delegate = self;
    bannerAds.adsSize = CGSizeMake(320, 50);
    
    [bannerAds loadAd];

b. 显示广告


    if ([self.bannerAds isReady]) {
        [self.bannerAds showAdWithView:self.bannerParentView];
    } else {
        NSLog(@"广告未准备好");
    }

SDK 具体调用方式参见demo，接入文档不再敖述。